<!DOCTYPE html>
<html>
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This file documents the use of the GNU compilers.

Copyright © 1988-2023 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "Funding Free Software", the Front-Cover
Texts being (a) (see below), and with the Back-Cover Texts being (b)
(see below).  A copy of the license is included in the section entitled
"GNU Free Documentation License".

(a) The FSF's Front-Cover Text is:

A GNU Manual

(b) The FSF's Back-Cover Text is:

You have freedom to copy and modify this GNU Manual, like GNU
     software.  Copies published by the Free Software Foundation raise
     funds for GNU development. -->
<title>Compatibility (Using the GNU Compiler Collection (GCC))</title>

<meta name="description" content="Compatibility (Using the GNU Compiler Collection (GCC))">
<meta name="keywords" content="Compatibility (Using the GNU Compiler Collection (GCC))">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta name="viewport" content="width=device-width,initial-scale=1">

<link href="index.html" rel="start" title="Top">
<link href="Indices.html" rel="index" title="Indices">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html" rel="up" title="Top">
<link href="Gcov.html" rel="next" title="Gcov">
<link href="Objective_002dC.html" rel="prev" title="Objective-C">
<style type="text/css">
<!--
a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
div.example {margin-left: 3.2em}
kbd.key {font-style: normal}
span:hover a.copiable-link {visibility: visible}
ul.mark-bullet {list-style-type: disc}
-->
</style>


</head>

<body lang="en_US">
<div class="chapter-level-extent" id="Compatibility">
<div class="nav-panel">
<p>
Next: <a href="Gcov.html" accesskey="n" rel="next"><code class="command">gcov</code>&mdash;a Test Coverage Program</a>, Previous: <a href="Objective_002dC.html" accesskey="p" rel="prev">GNU Objective-C Features</a>, Up: <a href="index.html" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Indices.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h2 class="chapter" id="Binary-Compatibility"><span>9 Binary Compatibility<a class="copiable-link" href="#Binary-Compatibility"> &para;</a></span></h2>
<a class="index-entry-id" id="index-binary-compatibility"></a>
<a class="index-entry-id" id="index-ABI"></a>
<a class="index-entry-id" id="index-application-binary-interface"></a>

<p>Binary compatibility encompasses several related concepts:
</p>
<dl class="table">
<dt><em class="dfn">application binary interface (ABI)</em></dt>
<dd><p>The set of runtime conventions followed by all of the tools that deal
with binary representations of a program, including compilers, assemblers,
linkers, and language runtime support.
Some ABIs are formal with a written specification, possibly designed
by multiple interested parties.  Others are simply the way things are
actually done by a particular set of tools.
</p>
</dd>
<dt><em class="dfn">ABI conformance</em></dt>
<dd><p>A compiler conforms to an ABI if it generates code that follows all of
the specifications enumerated by that ABI.
A library conforms to an ABI if it is implemented according to that ABI.
An application conforms to an ABI if it is built using tools that conform
to that ABI and does not contain source code that specifically changes
behavior specified by the ABI.
</p>
</dd>
<dt><em class="dfn">calling conventions</em></dt>
<dd><p>Calling conventions are a subset of an ABI that specify of how arguments
are passed and function results are returned.
</p>
</dd>
<dt><em class="dfn">interoperability</em></dt>
<dd><p>Different sets of tools are interoperable if they generate files that
can be used in the same program.  The set of tools includes compilers,
assemblers, linkers, libraries, header files, startup files, and debuggers.
Binaries produced by different sets of tools are not interoperable unless
they implement the same ABI.  This applies to different versions of the
same tools as well as tools from different vendors.
</p>
</dd>
<dt><em class="dfn">intercallability</em></dt>
<dd><p>Whether a function in a binary built by one set of tools can call a
function in a binary built by a different set of tools is a subset
of interoperability.
</p>
</dd>
<dt><em class="dfn">implementation-defined features</em></dt>
<dd><p>Language standards include lists of implementation-defined features whose
behavior can vary from one implementation to another.  Some of these
features are normally covered by a platform&rsquo;s ABI and others are not.
The features that are not covered by an ABI generally affect how a
program behaves, but not intercallability.
</p>
</dd>
<dt><em class="dfn">compatibility</em></dt>
<dd><p>Conformance to the same ABI and the same behavior of implementation-defined
features are both relevant for compatibility.
</p></dd>
</dl>

<p>The application binary interface implemented by a C or C++ compiler
affects code generation and runtime support for:
</p>
<ul class="itemize mark-bullet">
<li>size and alignment of data types
</li><li>layout of structured types
</li><li>calling conventions
</li><li>register usage conventions
</li><li>interfaces for runtime arithmetic support
</li><li>object file formats
</li></ul>

<p>In addition, the application binary interface implemented by a C++ compiler
affects code generation and runtime support for:
</p><ul class="itemize mark-bullet">
<li>name mangling
</li><li>exception handling
</li><li>invoking constructors and destructors
</li><li>layout, alignment, and padding of classes
</li><li>layout and alignment of virtual tables
</li></ul>

<p>Some GCC compilation options cause the compiler to generate code that
does not conform to the platform&rsquo;s default ABI.  Other options cause
different program behavior for implementation-defined features that are
not covered by an ABI.  These options are provided for consistency with
other compilers that do not follow the platform&rsquo;s default ABI or the
usual behavior of implementation-defined features for the platform.
Be very careful about using such options.
</p>
<p>Most platforms have a well-defined ABI that covers C code, but ABIs
that cover C++ functionality are not yet common.
</p>
<p>Starting with GCC 3.2, GCC binary conventions for C++ are based on a
written, vendor-neutral C++ ABI that was designed to be specific to
64-bit Itanium but also includes generic specifications that apply to
any platform.
This C++ ABI is also implemented by other compiler vendors on some
platforms, notably GNU/Linux and BSD systems.
We have tried hard to provide a stable ABI that will be compatible with
future GCC releases, but it is possible that we will encounter problems
that make this difficult.  Such problems could include different
interpretations of the C++ ABI by different vendors, bugs in the ABI, or
bugs in the implementation of the ABI in different compilers.
GCC&rsquo;s <samp class="option">-Wabi</samp> switch warns when G++ generates code that is
probably not compatible with the C++ ABI.
</p>
<p>The C++ library used with a C++ compiler includes the Standard C++
Library, with functionality defined in the C++ Standard, plus language
runtime support.  The runtime support is included in a C++ ABI, but there
is no formal ABI for the Standard C++ Library.  Two implementations
of that library are interoperable if one follows the de-facto ABI of the
other and if they are both built with the same compiler, or with compilers
that conform to the same ABI for C++ compiler and runtime support.
</p>
<p>When G++ and another C++ compiler conform to the same C++ ABI, but the
implementations of the Standard C++ Library that they normally use do not
follow the same ABI for the Standard C++ Library, object files built with
those compilers can be used in the same program only if they use the same
C++ library.  This requires specifying the location of the C++ library
header files when invoking the compiler whose usual library is not being
used.  The location of GCC&rsquo;s C++ header files depends on how the GCC
build was configured, but can be seen by using the G++ <samp class="option">-v</samp> option.
With default configuration options for G++ 3.3 the compile line for a
different C++ compiler needs to include
</p>
<div class="example smallexample">
<pre class="example-preformatted">    -I<var class="var">gcc_install_directory</var>/include/c++/3.3
</pre></div>

<p>Similarly, compiling code with G++ that must use a C++ library other
than the GNU C++ library requires specifying the location of the header
files for that other library.
</p>
<p>The most straightforward way to link a program to use a particular
C++ library is to use a C++ driver that specifies that C++ library by
default.  The <code class="command">g++</code> driver, for example, tells the linker where
to find GCC&rsquo;s C++ library (<samp class="file">libstdc++</samp>) plus the other libraries
and startup files it needs, in the proper order.
</p>
<p>If a program must use a different C++ library and it&rsquo;s not possible
to do the final link using a C++ driver that uses that library by default,
it is necessary to tell <code class="command">g++</code> the location and name of that
library.  It might also be necessary to specify different startup files
and other runtime support libraries, and to suppress the use of GCC&rsquo;s
support libraries with one or more of the options <samp class="option">-nostdlib</samp>,
<samp class="option">-nostartfiles</samp>, and <samp class="option">-nodefaultlibs</samp>.
</p>

</div>
<hr>
<div class="nav-panel">
<p>
Next: <a href="Gcov.html"><code class="command">gcov</code>&mdash;a Test Coverage Program</a>, Previous: <a href="Objective_002dC.html">GNU Objective-C Features</a>, Up: <a href="index.html">Introduction</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Indices.html" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
